home *** CD-ROM | disk | FTP | other *** search
/ AGA Toolkit '97 / The AGA Toolkit '97.iso / commodities / docs / appmenu.doc next >
Text File  |  1996-09-07  |  5KB  |  163 lines
  1. AppMenu
  2. Marius Chwalczyk
  3.  
  4. $VER: AppMenu 1.2 (29.04.93)
  5.  
  6. Copyright © 1993 by Marius Chwalczyk. All Rights Reserved.
  7.  
  8.  
  9.  
  10.    AppMenu is FREEWARE but copyrighted © 1993 by Marius Chwalczyk. It's freely
  11. distributable as long as all of its files are included in their original form
  12. without modifications of any kind. Only a moderate copying charge is allowed
  13. for its distribution. This program is "as-is", all use is at your own risk.
  14.  
  15.    AppMenu is a utility for Workbench. It runs only under Release 2 (V37) and
  16. later versions of the Amiga operating system. It's a commodity that adds menu
  17. items to the Workbench Tools menu. When a menu item is activated, AppMenu
  18. starts up a program you chosed. You can free define the items and programs to
  19. execute. All programs are started as separate, asynchronous processes. You can
  20. also choose arguments for these programs through icons or file requester.
  21.  
  22.  
  23. Installing and running.
  24. -----------------------
  25.  
  26.    To install AppMenu simple copy it where you want it to have. You can start
  27. it from Workbench or from Shell. Or just place it in the WBStartup drawer.
  28. The following arguments in the line command or the tool types in the icon are
  29. all optional.
  30.  
  31.    CX_PRIORITY=n
  32.    CX_POPUP=NO|YES
  33.    CX_POPKEY=hotkey
  34.  
  35. See Workbench handbook for this commodity tool types. Defaults are pririty 0,
  36. popup 'YES' and popkey 'shift f3'.
  37.  
  38.    FROM=prefs
  39.  
  40. 'prefs' is the preferences file (default "ENVARC:AppMenu/AppMenu.prefs"), where
  41. AppMenu saves the items. Each item contain a menu item text, a command text and
  42. a arguments specification.
  43.  
  44.    PROGITEM=NO|YES
  45.  
  46. * NEW 1.2 *: If you don't want 'AppMenu...' item in Tools menu choose NO.
  47. Default is YES.
  48.  
  49.  
  50. The interface.
  51. --------------
  52.  
  53.    AppMenu's window presents a list gadget with its scroller and a string field
  54. below, a separate string field, a cycle gadget, two buttons and a bank of four
  55. buttons. To call the window press the hothey, activate 'AppMenu...' item in
  56. Tools menu, run AppMenu again or use the Exchange program. Exchange can be use
  57. for some other things too (see its docs).
  58.  
  59.    The functions of the gadgets are:
  60.  
  61. Menu Items
  62.    This listview gadgets show the item list. To change a item just select it.
  63.    Now you can update the command text. Press Return or Tab key or change 'Arg'
  64.    gadget to activate the string field below the listview gadget. Here you can
  65.    modify the item text and press Return to take the item back to the list.
  66.  
  67. Command
  68.    Type the program name and its arguments you want to execute. Note that you
  69.    must specify the full path of the command when you start AppMenu from
  70.    Workbench.
  71.  
  72. Arg
  73.    Select if and from where you want arguments to a command. The possibilities
  74.    are:
  75.    
  76.    Requester   If you activate the item a file requester appears and you can
  77.                choose a file name as an argument to the command. You can cancel
  78.                the execution too.
  79.  
  80.    Icons       The names of selected icons in Workbench (if any) will be
  81.                arguments.
  82.  
  83.    Icons/Req   Same as above. If no icon selected as 'Requester'.
  84.  
  85.    None        Execute command without extra arguments.
  86.  
  87. New
  88.    Add a new item to the list. Just type a command text, choose 'Arg' and write
  89.    a menu item text. To quick add a program put its icon in the AppMenu window.
  90.    Its name will be the item text and its path with the name the command. The
  91.    number of items you can add is limited only by available memory, the system
  92.    (V37) however creates only 63 selectable menu items.
  93.    * NEW 1.2 *: To add a new item befor an existing item in the list simple
  94.    select this item first.
  95.  
  96. Del
  97.    To remove a item from the list select it and press the 'Del' gadget.
  98.  
  99. Save
  100.    Save the item list to the preferences file. Further as 'Use'.
  101.  
  102. Use
  103.    Close window, use current list to create item in Tools menu and execute
  104.    commands of the chosen items.
  105.  
  106. Cancel
  107.    Undo all changes in the list since the window is open, close it and use the
  108.    old list. Note that window's Close gadget and Exchange's Hide command have
  109.    the equal function.
  110.  
  111. Quit
  112.    Quit AppMenu. Ctrl-C makes it too. If the changed items are not saved first
  113.    appears a requester.
  114.  
  115. The last four buttons have menu equivalences with short-cuts.
  116.  
  117.  
  118. The Program and its Author.
  119. ---------------------------
  120.  
  121.    Localization will be done when I have WB2.1 update. Where is it for
  122. Germany?  :-(
  123.  
  124.    AppMenu is written in C and compiled with SAS/C 6.2. It's tested on an
  125. Amiga 3000 (KS 37.175, WB 37.71) with Enforcer and Mungwall.
  126.  
  127.    If you have some comments, additional ideas and/or bug reports, feel free
  128. to send me a letter or to call me.
  129.  
  130.    You can reach me via
  131.  
  132.           Mail: Marius Chwalczyk
  133.                 Zigelstr. 59/165
  134.                 D-6750 Kaiserslautern (Germany)
  135.  
  136.          Phone: (Germany)0631-10944
  137.  
  138. *** WARNING! E-Mail will be no more current soon! ***
  139.  
  140.         E-Mail: m_chwalc@informatik.uni-kl.de
  141.  
  142.  
  143. History.
  144. --------
  145.  
  146. 1.0 first internal release.
  147.       
  148. 1.1 (25.03.93) - first public release.
  149.  
  150.    Saving preferences in separate file instead of in tool types.
  151.    Added prefs-not-saved-requester.
  152.    Added 'Icons' as arguments.
  153.  
  154. 1.2 (29.04.93)
  155.  
  156.    No bugs found or reported - no bugs fixed!  :-)
  157.    Added possibility to arrange the order of the commands.
  158.       (Thanks to Kevin A. Kirk for this suggestion.)
  159.    Added PROGITEM argument.
  160.    File requester remember previous selections. 
  161.  
  162. -
  163.